home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 1998 November / IRIX 6.5.2 Base Documentation November 1998.img / usr / share / catman / u_man / cat1 / unexpand.z / unexpand
Text File  |  1998-10-20  |  7KB  |  199 lines
  1.  
  2.  
  3.  
  4. uuuunnnneeeexxxxppppaaaannnndddd((((1111))))                                                        uuuunnnneeeexxxxppppaaaannnndddd((((1111))))
  5.  
  6.  
  7.  
  8. NNNNAAAAMMMMEEEE
  9.      unexpand - convert spaces to tabs
  10.  
  11. SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  12.      uuuunnnneeeexxxxppppaaaannnndddd [ -a| -t tablist ] [ file..]
  13.  
  14. DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  15.      The _u_n_e_x_p_a_n_d utility copies files or the standard input to the standard
  16.      output, converting blank characters at the beginning of each line into
  17.      the maximum number of tab characters followed by the minimum number of
  18.      space characters needed to fill the same column positions originally
  19.      filled by the translated blank characters. By default, tabstops are set
  20.      at every eighth column position. Each backspace character is copied to
  21.      the output, and causes the column position count for tab calculations to
  22.      be decremented; the count will never be decremented to a value less than
  23.      one.
  24.  
  25. OOOOPPPPTTTTIIIIOOOONNNNSSSS
  26.      The following options are supported:
  27.  
  28.      ----aaaa   In addition to translating blank characters at the beginning of each
  29.           line, translate all sequences of two or more blank characters
  30.           immediately preceding a tab stop to the maximum number of tab
  31.           characters followed by the minimum number of space characters needed
  32.           to fill the same column positions originally filled by the
  33.           translated blank characters.
  34.  
  35.      ----tttt _t_a_b_l_i_s_t
  36.           Specify the tab stops. The option-argument tablist must be a single
  37.           argument consisting  of a single positive decimal integer or
  38.           multiple positive decimal integers, separated by blank characters or
  39.           commas, in ascending order. If a single number is given, tabs will
  40.           be set _t_a_b_l_i_s_t column positions apart instead of the default 8.  If
  41.           multiple numbers are given, the tabs will be set at those specific
  42.           column positions.
  43.  
  44.           Each tab-stop position _N must be an integer value greater than zero,
  45.           and the list must be in strictly ascending order. This is taken to
  46.           mean that, from the start of a line of output, tabbing to position _N
  47.           causes the next character output to be in the (_N+_1)_t_h column
  48.           position on that line. When the -t option is not specified, the
  49.           default is the equivalent of specifying -t 8 (except for the
  50.           interaction with -a, described below).
  51.  
  52.           No space-to-tab character conversions occur for characters at
  53.           positions beyond the last of those specified in a multiple tab-stop
  54.           list.
  55.  
  56.           When -t is specified, the presence or absence of the -a option is
  57.           ignored; conversion will not be limited to the processing of leading
  58.           blank characters.
  59.  
  60.  
  61.  
  62.  
  63.                                                                         PPPPaaaaggggeeee 1111
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70. uuuunnnneeeexxxxppppaaaannnndddd((((1111))))                                                        uuuunnnneeeexxxxppppaaaannnndddd((((1111))))
  71.  
  72.  
  73.  
  74. OOOOPPPPEEEERRRRAAAANNNNDDDDSSSS
  75.      The following operand is supported:
  76.  
  77.      -t _f_i_l_e   The pathname of a text file to be used as input.
  78.  
  79. SSSSTTTTDDDDIIIINNNN
  80.      See IIIINNNNPPPPUUUUTTTT FFFFIIIILLLLEEEESSSS....
  81.  
  82. IIIINNNNPPPPUUUUTTTT FFFFIIIILLLLEEEESSSS
  83.      Input files must be text files.
  84.  
  85. EEEENNNNVVVVIIIIRRRROOOONNNNMMMMEEEENNNNTTTT VVVVAAAARRRRIIIIAAAABBBBLLLLEEEESSSS
  86.      The following environment variables affect the execution of _u_n_e_x_p_a_n_d:
  87.  
  88.      _L_A_N_G      Provide a default value for the internationalisation variables
  89.      that are unset or null. If _L_A_N_G is unset or null, the corresponding value
  90.      from the implementation-specific default locale will be used. If any of
  91.      the internationalisation variables contains an invalid setting, the
  92.      utility will behave as if none of the variables had been defined.
  93.  
  94.      _L_C__A_L_L      If set to a non-empty string value, override the values of
  95.      all the other internationalisation variables.
  96.  
  97.      _L_C__C_T_Y_P_E      Determine the locale for the interpretation of sequences of
  98.      bytes of text data as characters (for example, single- as opposed to
  99.      multi-byte characters in arguments and input files), the processing of
  100.      tab and space characters, and for the determination of the width in
  101.      column positions each character would occupy on a constant-width font
  102.      output device.
  103.  
  104.      _L_C__M_E_S_S_A_G_E_S      Determine the locale that should be used to affect the
  105.      format and contents of diagnostic messages written to standard error.
  106.  
  107.  
  108. AAAASSSSYYYYNNNNCCCCHHHHRRRROOOONNNNOOOOUUUUSSSS EEEEVVVVEEEENNNNTTTTSSSS
  109.      Default.
  110.  
  111.  
  112. SSSSTTTTDDDDOOOOUUUUTTTT
  113.      The standard output is equivalent to the input files with the specified
  114.      space to tab character conversions.
  115.  
  116.  
  117. SSSSTTTTDDDDEEEERRRRRRRR
  118.      Used only for diagnostic messages.
  119.  
  120.  
  121. OOOOUUUUTTTTPPPPUUUUTTTT FFFFIIIILLLLEEEESSSS
  122.      None.
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.                                                                         PPPPaaaaggggeeee 2222
  130.  
  131.  
  132.  
  133.  
  134.  
  135.  
  136. uuuunnnneeeexxxxppppaaaannnndddd((((1111))))                                                        uuuunnnneeeexxxxppppaaaannnndddd((((1111))))
  137.  
  138.  
  139.  
  140. EEEEXXXXTTTTEEEENNNNDDDDEEEEDDDD DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  141.      None.
  142.  
  143.  
  144. EEEEXXXXIIIITTTT SSSSTTTTAAAATTTTUUUUSSSS
  145.      The following exit values are returned:
  146.  
  147.      0 Successful completion.
  148.  
  149.      >0 An error occured.
  150.  
  151.  
  152. CCCCOOOONNNNSSSSEEEEQQQQUUUUEEEENNNNCCCCEEEESSSS OOOOFFFF EEEERRRRRRRROOOORRRRSSSS
  153.      Dafault.
  154.  
  155.  
  156. AAAAPPPPPPPPLLLLIIIICCCCAAAATTTTIIIIOOOONNNN UUUUSSSSAAAAGGGGEEEE
  157.      One non-intuitive aspect of _u_n_e_x_p_a_n_d is its restriction to leading spaces
  158.      when neither -a nor -t is specified. Users who desire to always convert
  159.      all spaces in a file can easily alias _u_n_e_x_p_a_n_d to use the -a or -t 8
  160.      option.
  161.  
  162.  
  163. EEEEXXXXAAAAMMMMPPPPLLLLEEEESSSS
  164.      None.
  165.  
  166.  
  167. FFFFUUUUTTTTUUUURRRREEEE DDDDIIIIRRRREEEECCCCTTTTIIIIOOOONNNNSSSS
  168.      None.
  169.  
  170.  
  171. SSSSEEEEEEEE AAAALLLLSSSSOOOO
  172.      _t_a_b_s, _e_x_p_a_n_d
  173.  
  174.  
  175. CCCCHHHHAAAANNNNGGGGEEEE HHHHIIIISSSSTTTTOOOORRRRYYYY
  176.      First released in Issue 4.
  177.  
  178.  
  179.  
  180.  
  181.  
  182.  
  183.  
  184.  
  185.  
  186.  
  187.  
  188.  
  189.  
  190.  
  191.  
  192.  
  193.  
  194.  
  195.                                                                         PPPPaaaaggggeeee 3333
  196.  
  197.  
  198.  
  199.